home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Misc Utils / Global Search 1.03 / Global Search 1.03 docs < prev   
Text File  |  1993-05-06  |  3KB  |  49 lines

  1. Alessandro Levi Montalcini
  2. C.so Re Umberto 10
  3. 10121 Torino
  4. Italy
  5.  
  6. Global Search 1.03 documentation
  7. May 1993
  8.  
  9. • SHAREWARE - $3 -  CASH ONLY
  10. ◊  This program is distributed as Shareware: if you like it or use it please honor the shareware system by sending $3 to the author at the address above. Since collecting international cheques is very expensive, please send cash only. If you MUST send a cheque, keep in mind that the banks will gobble up more than half of it.
  11. ◊  NOTE: Getting some (usually very few) bucks is what you write shareware for, but getting a note, a postcard or anything else is a lot better than getting nothing. I'd like to know how far this program has gone, so remember that you can do something nice even if you don't have a couple of $$$ to spare.
  12.  
  13. • GENERAL INFO
  14. ◊  Global Search is a small utility that lets you search for an hexadecimal or character string in all the resources of a file. It generates a text file named "xxx.scan" (where xxx is the name of the searched file) with a log of all the matches that have been found. Each match is shown in the form:
  15.  
  16.   [RES TYPE] [RES ID]   "[RES NAME]"   $[OFFSET]
  17.  
  18. where [offset] is the offset in bytes from the beginning of the resource.
  19. ◊  Global Search was written for all ResEdit users (such as myself) who miss a global "Find Hex" command in that otherwise wonderful application.
  20.  
  21. • OPTIONS
  22. ◊  The main dialog lets you configure the search as follows:
  23.    - [HEX/ASCII] switches between an hexadecimal and a character search;
  24.    - [ALL RES/RES TYPE] search all resource types or just the chosen one;
  25.    - [ALL MATCHES/FIRST MATCH] find all matches or stop at the first one;
  26.    - [CREATOR] text file creator (i.e. 'ttxt', 'MSWD') for the scan log;
  27.    - [TAB SIZE] number of spaces in a tab (proportional tabs only);
  28.    - [SPACES/PROPORTIONAL/SINGLE] different formats for text alignment;
  29.    - [SCAN FILE] select a file to search and start scanning it…
  30.  
  31. • NOTE
  32. ◊  I haven't spent much time in drawing error dialogs - all errors should be handled correctly, but what you'll see may be somewhat confusing. If you choose "Cancel" in the standard open file dialog, for example, Global Search will inform you that it hasn't found any matches. Any error, including starting the search without a valid hex or ASCII string in the "Search for" edit field, will lead to the same no-info error message.
  33. ◊  If anyone out there uses this app and needs more error reporting, just let me know and I'll fix it.
  34.  
  35. • DISCLAIMER
  36. ◊  "No warranties at all, either express or implied…" No kidding, this is good old use-it-at-your-own-risk shareware; it shouldn't do any damage, but if it does then you'll be on your own. Let me know of any bugs you run into, anyway.
  37.  
  38. • VERSION HISTORY:
  39. ◊  1.03 - Minor fixes.
  40. ◊  1.02 - A bug which caused random words to appear at the end of the list has been fixed.
  41. ◊  1.01 - A minor layout problem with single tabs has been fixed.
  42. ◊  1.00 - First release.
  43.  
  44. •  HAVE FUN! And don't forget to $$$ SEND YOUR CONTRIBUTION $$$ so that more cool utilities will see the light in the near future, at the low-low-low costs of shareware.
  45.  
  46.  
  47.                      Best Regards,
  48.                                             Alessandro Levi Montalcini
  49.